home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Games Collection 1 / software vault.zip / software vault / CDR06 / TWHELP70.ZIP / README.TXT < prev    next >
Text File  |  1993-09-20  |  24KB  |  452 lines
  1.                              Trade Wars Helper 
  2.                                 Release 7.0 
  3.  
  4.                               Copyright 1993 
  5.                              Just FUN Software 
  6.                             All Rights Reserved 
  7.  
  8.  
  9.   Trade Wars Helper is a terminal program used ONLINE with the BBS door
  10.   game "Trade Wars 2002" v1.03 published by Mertech Software.  This
  11.   program continuously maintains a database of the explored sectors with
  12.   their port, adjacent sectors, and other information.  Several commands
  13.   are available to utilize this data while moving around the Trade Wars
  14.   universe including the ability to graphically map a sector and its warps
  15.   to any level!  In addition there are many commands that automate the
  16.   repetitive processes such as negotiating trades on your behalf and
  17.   automatically cross trade between two sectors.  Using this program will
  18.   significantly enhance both your effectiveness and your enjoyment of
  19.   Trade Wars.  Don't leave FedSpace without it! 
  20.  
  21.  
  22.  
  23.   INSTALLATION INSTRUCTIONS 
  24.  
  25.   Make a directory, \twhelp, on your hard disk using the DOS mkdir
  26.   command.  Unzip the ZIP file to the \twhelp directory. 
  27.  
  28.   Erase the TWHELP.CFG file if it is present.  The program will create a
  29.   new configuration file for use with data related to your installation. 
  30.  
  31.   Create a batch file (TWH.BAT) in the directory of your communications
  32.   program like below.  It changes to the \twhelp directory, executes the
  33.   twhelp program, then changes back to your communication program's
  34.   directory. 
  35.  
  36.   cd \twhelp 
  37.   twhelp 
  38.   cd \(comm-prog-dir) 
  39.  
  40.   Print the COMMANDS.TXT file.  It contains a listing of all the commands
  41.   and important points.  Use it as reference guide. 
  42.  
  43.  
  44.  
  45.   RUNNING INSTRUCTIONS 
  46.  
  47.   Run your communications program, login to a BBS and start the Trade Wars
  48.   door.  When Trade Wars begins building its title screen, shell to DOS
  49.   from your communications program and enter TWH to start the batch
  50.   program.  Resolving an insufficient memory condition is discussed below. 
  51.  
  52.   The program will begin with some configuration questions and then ask
  53.   for the file name(s) to use.  There is one database file for each BBS
  54.   game you play.  Once the configuration portion is completed, you begin
  55.   with the main program.  The configuration portion is not repeated on
  56.   subsequent runs although you are given a means to change the options.
  57.  
  58.   The commands and important points are discussed in the COMMANDS.TXT
  59.   file.  That file is generally printed for use as a reference guide.  You
  60.   can display a menu of commands while online by entering /?.  All TWH
  61.   command begin with the / character.  Commands are case sensitive.  That
  62.   is, /b is different from /B. 
  63.  
  64.   You can use Trade Wars Helper with an existing game or a new game.  For
  65.   an existing game use the /k command to initialize the database for
  66.   sectors you have previously explored.  You generally only use this
  67.   command once per existing BBS game.  The /K command can be used later to
  68.   ensure the database is up to date in the event of a hardware failure.
  69.   It will not reissue TW commands to acquire warp to and port information
  70.   for those sectors already in the database. 
  71.  
  72.   You can run the program directly without being connected to a BBS and
  73.   the Trade Wars door.  This might be useful the first time to enter the
  74.   configuration options. 
  75.  
  76.   In addition, the file EXAMPLE.TWH contains a database that can be used
  77.   to experiment with the program without being online.  You will need to
  78.   include the sector number after the / for most commands since the
  79.   current sector remains at last entered sector when not online.  Also do
  80.   not use the /e, /k, /t and most of the advanced commands when not online
  81.   since they issue commands to Trade Wars itself.
  82.  
  83.   For commands like /e, /k, /t and most of the advanced commands Trade
  84.   Wars Helper wait for specific text sequences from Trade Wars before
  85.   proceeding.  It is inevitable that from time to time something will get
  86.   Trade Wars and Trade Wars Helper out of synchronization.  This will
  87.   become apparent when TW Helper goes into an indefinite wait (i.e nothing
  88.   is happening and you can not enter a command).  Simply press the ESC and
  89.   Enter keys until something, such as Trade Wars main command prompt, is
  90.   displayed to get the two programs back in synch. 
  91.  
  92.   You can start the program and specify the database number (1-30) on the
  93.   command line.  For example a batch file line might be TWHELP 21 which
  94.   would start Trade Wars Helper using BBS data file 21.  The title screen
  95.   is not displayed in this case.
  96.  
  97.  
  98.  
  99.   INSUFFICIENT MEMORY 
  100.  
  101.   Trade Wars Helper requires a minimum of 300K to operate and some
  102.   communication programs require around 300K which puts you up against the
  103.   DOS 640K barrier.  The following discuses some of the thing you can do
  104.   to resolve this situation. 
  105.  
  106.   First make as much conventional memory available as possible.  This
  107.   means moving drivers, etc. to high memory.  DOS 6.0 MEMMAKER program
  108.   does a good job of this. 
  109.  
  110.   Check your comm program for an option to maximize the DOS shell memory.
  111.   Telemate has this useful capability. 
  112.  
  113.   Lower one or both of the configurations options that affect memory - the
  114.   scroll back buffer size and the communications buffer size.  If the
  115.   communications buffer is too small it will generally show up when using
  116.   a command that accesses the CIM.  A message will be displayed informing
  117.   you to increase the size of the communications buffer. 
  118.  
  119.   Another alternative is to not shell to DOS but, instead, after opening
  120.   the TW door, quit your comm program and then start TWHELP (assumes you
  121.   can quit your comm program without dropping carrier).  Of course after
  122.   quitting TW you will need to restart your comm program.  Some comm
  123.   programs, such as Procomm for Windows, seem to reset the ports baud rate
  124.   when you quit them.  You will recognize this when, after starting TWH,
  125.   it is unable to communicate with the BBS. In this case you will first
  126.   have to change the configuration option to enter the baud rate for each
  127.   BBS. After changing the option, reenter the bbs data filenames then
  128.   enter their baud rates.
  129.  
  130.   Still another alternative is to use another comm program.  Telemate has
  131.   an option that allows a maximum DOS shell and you can also quit it
  132.   without dropping carrier or having to enter a baud rate. 
  133.  
  134.  
  135.  
  136.   UPGRADE INSTRUCTIONS 
  137.  
  138.   If you are upgrading from an older release you can just unzip (or copy)
  139.   all the files from the new release directly into the /twhelp directory.
  140.   You will not need to do anything else.  It is not necessary to do the /k
  141.   command again since any changes to the data files will be automatically
  142.   handled by the program.  You should review the Configuration Options as
  143.   new options may have been added. 
  144.  
  145.   Once you have run the new release you can not go back to an older
  146.   release.  This is because the configuration and bbs data files will
  147.   frequently contain additional information that the older release will
  148.   not be aware of. 
  149.  
  150.  
  151.  
  152.   TW2002 VERSION 2.00 BETA 
  153.  
  154.   Changes have been made to TW Helper necessary to work with TW2002
  155.   version 2.00 release 0.20 being beta tested at this time.  However, as
  156.   that program is being changed on a regular basis, I've decided not to
  157.   make available the "Large Universe" version of TW Helper until the final
  158.   version 2 is available.  It's possible to use this release in version 2
  159.   games of 3000 sectors or less.  However any changes to version 2 could
  160.   make TW Helper partially or totally unusable with it until the next
  161.   release which will probably be when version 2 is completed.
  162.  
  163.  
  164.  
  165.   UNIVERSE MAPPING FEATURE 
  166.  
  167.   New with release 7.0 is the Universe Mapping Feature which is discussed
  168.   in the DOCMAPER.TXT file.  It is an extra charge capability requiring
  169.   a special registration key to activate.  As there are no provisions for
  170.   trying this module before activating it, read the DOCMAPER.TXT file
  171.   carefully.  There can be no refunds once the key has been given out. 
  172.  
  173.  
  174.  
  175.   SHAREWARE DISTRIBUTED PRODUCT 
  176.  
  177.   A product distributed via shareware is not "free software".  If you try
  178.   a shareware program and continue using it, you are expected to register
  179.   it with the author for a modest fee within 30 days of your initial
  180.   usage.  You may register this product by mailing cash, check or a money
  181.   order for $12.00 US (universe mapping feature and S&H extra) to: 
  182.  
  183.                  Just FUN Software 
  184.                  4790 Naniloa Dr. 
  185.                  Salt Lake City, UT 84117-5547 
  186.  
  187.   Upon receipt of the registration fee, you will be mailed instructions to
  188.   include your name in the program as the registered user and activate the
  189.   registered features.  The return letter is generally mailed the same day
  190.   the registration fee is received.
  191.  
  192.   You must use the REGISTER.TXT file when registering to avoid delays due
  193.   to lack of appropriate information.  If you wish to use the universe
  194.   mapping feature, also include the REGMAPER.TXT form.  These files may be
  195.   printed using DOS commands.  For example: 
  196.  
  197.                  print \twhelp\register.txt 
  198.               or copy \twhelp\register.txt lpt1 
  199.  
  200.   Well over 1200 hours have been invested in developing and enhancing this
  201.   product.  That makes the registration fee less than one cent per hour of
  202.   development time.  Please do not use, or allow others to use, the
  203.   registered features of this program without paying this modest fee. 
  204.  
  205.  
  206.  
  207.   COPYRIGHT 
  208.  
  209.   Copyright laws apply to both shareware and commercial software, and the
  210.   copyright holder retains all rights, with the following exception.  The
  211.   unmodified program files, complete with the files discussed below, may
  212.   be freely copied and distributed.  It is in fact encouraged.  If you
  213.   like this program, please tell your fellow players, even those evil
  214.   traders, about it and upload it to several BBSes.  Of course,
  215.   registrations key may not be distributed. 
  216.  
  217.   It one thing to use an unregistered shareware product over the 30 day
  218.   trial period.  Nothing will happen if you do.  It's quite another thing
  219.   to provide others with a registration key or modify a program file in an
  220.   attempt to circumvent the registration key.  Those activities are
  221.   illegal.  As such, a reward, commensurate with the scope of the illegal
  222.   activity involved, will be given to any individual providing information
  223.   on any person or persons unlawfully providing registration keys for this
  224.   product and/or modified version of this product to any other individual
  225.   or BBS. In addition, this product has been specially coded to detect
  226.   such illegal activity and will retaliate accordingly. 
  227.  
  228.  
  229.  
  230.   DISCLAIMER 
  231.  
  232.   Trade Wars Helper is supplied on an "as is" basis.  The author disclaims
  233.   all warranties, expressed or implied, including, without limitation, the
  234.   warranties of merchantability and of fitness for any purpose.  The
  235.   author assumes no liability for damages, direct or consequential, which
  236.   may result for the use of Trade Wars Helper. 
  237.  
  238.  
  239.  
  240.   FILES 
  241.  
  242.   This product is made up of the following files. 
  243.  
  244.   README.TXT - The file you are now reading. 
  245.  
  246.   README2.TXT - A continuation of the README file.   
  247.  
  248.   REGISTER.TXT - This file contains a printable registration form.  Please
  249.   use this form when registering. 
  250.  
  251.   REGMAPER.TXT - This file contains the registration form for the Universe
  252.   Mapping Feature. 
  253.  
  254.   DOCMAPER.TXT - This file discusses the Universe Mapping Feature.
  255.  
  256.   COMMANDS.TXT - This file contains a reference guide to the commands. 
  257.  
  258.   ANNOUNCE.TXT - This file contains an announcement of release 7.0 of
  259.   Trade Wars Helper suitable for posting on a BBS or network. 
  260.  
  261.   DESCRIPT.TXT - This file contains a full description of Trade Wars
  262.   Helper suitable for posting on a BBS or network. 
  263.  
  264.   FILE_ID.DIZ - A description of this product for PCBoard systems. 
  265.  
  266.   TWHELP.EXE - The standard version program file. 
  267.  
  268.   TWHSETUP.EXE - The setup program file. 
  269.  
  270.   TWHMAPER.EXE - The universe mapping feature program file. 
  271.  
  272.   EXAMPLE.TWH - This file contains an example database that can be used to
  273.   experiment with the program.
  274.  
  275.   This product may be distributed only when all the above files are
  276.   included in the distribution in unmodified form. 
  277.  
  278.  
  279.  
  280.   RELEASE ACTIVITY 
  281.  
  282.   Release 1.0: September 7, 1992 - Initial release. 
  283.  
  284.   Release 1.1: September 11, 1992 - Made the COMM port and baud rate
  285.   user options.  Changed some of the edit keys for the /b and /c commands. 
  286.  
  287.   Release 1.2: September 30, 1992 - Eliminated the need to specify the
  288.   baud rate.  Added configuration option to optionally reissue the
  289.   universal announcement. 
  290.  
  291.   Release 2.0: October 12, 1992 - Added the /t, Negotiate Trade, command
  292.   along with the automatic cross trading capability.  Also added the /s,
  293.   Search for notation characters, command. 
  294.  
  295.   Release 2.1: October 20, 1992 - Added the option to specify the baud
  296.   rate for those instances where automatic determination does not work. 
  297.  
  298.   Release 3.0: January 5, 1993 - Added the /X, /I, and /U commands to
  299.   expand the search for the next six sectors.  Fixed the problem that
  300.   occurred when entering more than seven data file names at one time.
  301.   Fixed problem associated with using the /k command at high transfer
  302.   rates.  Allowed for ESC to exit program at title screen. 
  303.  
  304.   Release 3.1: February 8, 1993 - Changed the /k command to use the Crai
  305.   computer's interrogation mode to collect the warp to sector information.
  306.   Changed the search for matching notation characters command to /m (was
  307.   /s).  Added the configuration option to enter the IRQ line number.
  308.   Fixed bug that may have caused the auto trading feature to randomly
  309.   fail. 
  310.  
  311.   Release 3.2: February 12, 1993 - Fixed communications software to work
  312.   with modems and I/O cards using the 16550A UART. 
  313.  
  314.   Release 4.0: March 1, 1993 - Added /r command which interrogates the
  315.   Crai computer to record the product percentage for display with the /x
  316.   command information.  Added the /s command which initiates an automatic
  317.   sell/steal cycle.  Added the /> command which prints the command and
  318.   information screens on the standard print device.  Added the /e command
  319.   which explores the closest unexplored sector.  Added the /Z (formerly
  320.   /E) command which clears the explored status for each sector without
  321.   clearing it's port and warp to information.  Added the /o command which
  322.   allows entry of the run time options (RTO).  Added the bugle calls used
  323.   to alert the completion of lengthy processes. 
  324.  
  325.   Release 5.0: April 5, 1993 - Added the capture file feature and the
  326.   scroll back buffer feature.  Added the /D command which shells to DOS.
  327.   Added the /F command which creates data files for the offline analysis
  328.   program TWVIEW and TWASSIST.  Upgraded the communications software to
  329.   the newest version.  Incorporated the results of the psychic probe
  330.   during trading to optimize the experience points realized for the auto
  331.   /t and /s commands.  Added the /l command which is used (after the /r
  332.   command) to locate enemy forces.  Fixed the problem with printing to a
  333.   laser printer.  Added the /d command to display the destination path
  334.   from the current sector.  Added the ability to cross trade between
  335.   nonadjacent sectors using ships equipped with a TransWarp Drive.
  336.   Expanded the Deployed Fighter Scan produced by Trade Wars to include the
  337.   port type, notation characters, product percentages and optionally, the
  338.   number of hops from the current sector.  Added the /f command to deploy
  339.   a single fighter in the toll mode.  Added the /C command which initiates
  340.   automatic colonization of a planet with ability to utilize a TransWarp
  341.   drive when available.  Added the /B command which initiates the
  342.   automatic buying and conveying of product to a planet.  Allowed for
  343.   cross trading between class 4 (SSB) and class 6 (BSS) ports.  Added a
  344.   Run Time Option to specify whether a ship equipped with a Holographic
  345.   Scanner stops at the sector preceding the unexplored sector when using
  346.   the /e command.  Added the /P command which displays the next six
  347.   sectors with a specified port capability.  Added the /E command which
  348.   launches an E-probe to a randomly chosen unexplored sector.  Allowed for
  349.   specifying the database number on the command line.  Changed the /k
  350.   command to use the CIM for both sector and port information. 
  351.  
  352.   Release 5.5: May 17, 1993 - Added the /& command to display the next
  353.   five sectors for the /x, /u, /p, etc.  commands.  Changed the command to
  354.   create the offline analysis files for TWVIEW and/or TWASSIST to /V and
  355.   added the option to create only the individual .FRT, .SCT or .PRT files.
  356.   Made the TWVIEW .SCT file compatible with TWMAP.  Added deployed
  357.   fighters, identified by the TW G and TWH /F (formerly /f) commands, to
  358.   the /d display.  Added the /f command to display the paths to a
  359.   destination sector from the nearest five sectors containing fighters
  360.   preceded by the numbers of hops to the fighters from the current sector.
  361.   Added a check to the /F command to insure fighters are not deployed in
  362.   FedSpace.  Added the /0E command to mark a sector as inaccessible for
  363.   the /E routines.  Added the /1E command to launch an E-probe to a
  364.   randomly chosen isolated sector.  Added the /2E command to launch an
  365.   E-probe so as to pass thru the most sectors not visited during the
  366.   current session.  Added a configuration option so advanced commands are
  367.   only displayed or printed if desired for new users.  Added the /m
  368.   command to display a menu of all the commands on a single screen.  Added
  369.   the /< command to output the online documentation to the text file
  370.   TWHELP.DOC.  Moved the option to sound the bugle calls to the
  371.   configuration options screen.  Added the /M command to merge another
  372.   traders database.  Made the automated process restore the default ANSI
  373.   color which is useful when the TW ANSI mode is off.  Added the analysis
  374.   of the TW Computer X command display to keep track of avoided sectors
  375.   which now are not shown on the various displays or moved to via the /e
  376.   command.  Allowed for cross trading between a class 8 (BBB) port and any
  377.   other class of port.  Allowed for cross trading between a class 7 (SSS)
  378.   port and any other port buying equipment.  Allowed for cross trading
  379.   between two nonadjacent sectors without using the Transwarp Drive.
  380.   Allowed for triple trading which involves all three products at each
  381.   port to maximize experience points.  Added the /X command which displays
  382.   the five closest sectors for nonadjacent cross trading pairs, transwarp
  383.   trading pairs, triple trading pairs, and other specialized combinations.
  384.   Added the product quantities from the /r command to the /x, /p and other
  385.   command displays.  Added a Run Time Option to turn off the haggling over
  386.   price when trading.  Added the /P command which automates the process of
  387.   buying planetary shields with or without using a TransWarp Drive.  Added
  388.   the /Q command which automates the quashing of mines using mine
  389.   disruptors.  Added the /g command which goes to a specified sector while
  390.   optionally deploying fighters (RTO), trading (RTO) and density scanning
  391.   (RTO) along the way.  Added an RTO to optionally deploy/trade/scan when
  392.   using the /e command and added the /2e command which initiates automatic
  393.   exploration of the TW universe.  Added the automatic determination of
  394.   which sectors are Major Space Lanes which are noted as MSL on some
  395.   displays.  Significantly modified the /w display.  Added the /I command
  396.   to display deeply isolated sectors.  Added a configuration option to
  397.   optionally save the fighter, product percentage, and product quantity
  398.   data in the disk file.  Added prompts to the /k command to ask for the
  399.   class 0 and 9 sectors.  Changed the way the destination sector is
  400.   specified for the /d command.  Based on hearsay regarding the new
  401.   release of Trade Wars made the commands that use the CIM allow for
  402.   missing sectors and added a prompt to allow for upto 3000 sectors. 
  403.  
  404.   Release 5.6: May 19, 1993 - Fixed problem of locking up when entering
  405.   number of sectors in universe. 
  406.  
  407.   Release 6.0: June 5, 1993 - Added the /G command to graphically display
  408.   a sector and its warps to any level.  Separated the configuration
  409.   options portion of TWHELP.EXE to a separate file TWHSETUP.EXE.  Added a
  410.   configuration option to specify the size of the communications buffer.
  411.   Changed the /b and /c edit routine so the enter key can insert a line
  412.   and the del key can remove a line.  Added the /R command to initiate the
  413.   robing credits cycle which included a new RTO to set the rob percentage.
  414.   Fixed a bug in the /I routine.  Fixed a bug in displaying the scroll
  415.   back buffer that did damage to the database and configuration files.
  416.   Added communicating at 38,400 and 57,600 bps capability. 
  417.  
  418.   Release 7.0: September 23, 1993 - Fixed problem related to accepting
  419.   the first offer while trading instead of haggling.  Fixed problem with
  420.   the /P command hanging up when the TW ANSI was turned off.  Added the /L
  421.   command to lower population levels to maximize fighters produced.
  422.   Changed the /B command to optionally use the TransWarp Drive.  Added the
  423.   /h command to haul colonists, products, or shields from one planet to
  424.   another optionally using the TransWarp Drive.  Fixed problem with extra
  425.   CR in capture file and TWHELP.DOC causing extra LF for some editors.
  426.   Changed /g command to ignore density for FedSpace sectors so they are
  427.   always entered.  Changed the /R command to rob down to 1000 credits and
  428.   to rob 10 percent more than the credits reported.  Fixed problem with /r
  429.   command not clearing percentages first which caused the /l command to
  430.   not works properly.  Made the commands like /d that display a path to
  431.   sectors work faster.  Changed the /B command to buy product for a planet
  432.   and/or sell product from a planet.  Added the /H command to heist
  433.   product for a planet with or without using the TransWarp Drive.  Fixed
  434.   problem with /t trying to transwarp when no fighter is present in
  435.   sectors.  Removed the online command documentation from the program to
  436.   save memory and created the command.txt file as a reference document
  437.   instead.  Tested against the new TW version 2 beta release and made
  438.   the changes necessary for compatibility.  This included allowing the /s
  439.   command to move between sectors, added subcommands for the /X command,
  440.   expanding the number of pages for the /b command, and various other
  441.   changes to account for differences between versions 1.03 and 2.00.
  442.   Created the extra charge Universe Mapping module and the corresponding
  443.   /6E and 7E command.  Changed the Ether Probe routines to automatically
  444.   launch the probes.  Added saving the database to disk when the /D
  445.   command is issued.  Added the /3E command to launch E-probes to isolated
  446.   sectors sequentially and keeping track of the last sector probed.  Added
  447.   an RTO to specify the number of fighters to automatically attack enemy
  448.   fighters encountered when using the /g and /e commands. 
  449.  
  450.  
  451.   Please continue by reading the README2.TXT file. 
  452.